home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / Dev / SmallTalk / Character.st < prev    next >
Text File  |  1995-08-25  |  6KB  |  237 lines
  1. "======================================================================
  2. |
  3. |   Character Method Definitions
  4. |
  5.  ======================================================================"
  6.  
  7.  
  8. "======================================================================
  9. |
  10. | Copyright (C) 1990, 1991, 1992 Free Software Foundation, Inc.
  11. | Written by Steve Byrne.
  12. |
  13. | This file is part of GNU Smalltalk.
  14. |
  15. | GNU Smalltalk is free software; you can redistribute it and/or modify it
  16. | under the terms of the GNU General Public License as published by the Free
  17. | Software Foundation; either version 1, or (at your option) any later version.
  18. | 
  19. | GNU Smalltalk is distributed in the hope that it will be useful, but WITHOUT
  20. | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  21. | FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  22. | details.
  23. | 
  24. | You should have received a copy of the GNU General Public License along with
  25. | GNU Smalltalk; see the file COPYING.  If not, write to the Free Software
  26. | Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  
  27. |
  28.  ======================================================================"
  29.  
  30.  
  31. "
  32. |     Change Log
  33. | ============================================================================
  34. | Author       Date       Change 
  35. | sbb         16 Mar 91      Class creation now separate statement.
  36. |
  37. | sbb         22 Sep 90      Changed character to always print with a leading $.
  38. |
  39. | sbyrne     16 May 90      Changed from being variableSubclass to
  40. |              variableWordSubclass.
  41. |
  42. | sbyrne     25 Apr 89      created.
  43. |
  44. "
  45.  
  46.  
  47. "*** Having this be variable seems wrong ***"
  48. Magnitude variableWordSubclass: #Character 
  49.       instanceVariableNames: ''
  50.       classVariableNames: ''
  51.       poolDictionaries: ''
  52.       category: nil
  53. !
  54.  
  55. Character comment: 
  56. 'My instances represent the 256 characters of the character set.  I provide
  57. messages to translate between integers and character objects, and provide
  58. names for some of the common unprintable characters.' !
  59.  
  60.  
  61. !Character class methodsFor: 'constants'!
  62.  
  63. backspace
  64.     "Returns the character 'backspace'"
  65.     ^Character value: 8
  66. !
  67.  
  68. tab
  69.     "Returns the character 'tab'"
  70.     ^Character value: 9
  71. !
  72.  
  73. nl
  74.     "Returns the character 'nl'"
  75.     ^Character value: 10
  76. !
  77.  
  78. newPage
  79.     "Returns the character 'newPage'"
  80.     ^Character value: 12
  81. !
  82.  
  83. cr
  84.     "Returns the character 'cr'"
  85.     ^Character value: 13
  86. !
  87.  
  88. esc
  89.     "Returns the character 'esc'"
  90.     ^Character value: 27
  91. !
  92.  
  93. space
  94.     "Returns the character 'space'"
  95.     ^Character value: 32    "could also return $ "
  96. !!
  97.  
  98.  
  99. !Character class methodsFor: 'Instance creation'!
  100.  
  101. digitValue: anInteger
  102.     "Returns a character that corresponds to anInteger.  0-9 map to $0-$9,
  103.     10-35 map to $A-$Z"
  104.     (anInteger between: 0 and: 9)
  105.         ifTrue: [ ^Character value: anInteger + 48 ]. "48 == $0"
  106.     (anInteger between: 10 and: 35)
  107.         ifTrue: [ ^Character value: anInteger - 10 + 65 ]. "65 = $A"
  108.     ^self error: 'value not in range 0 to 35'
  109. !!
  110.  
  111.  
  112.  
  113. !Character methodsFor: 'converting'!
  114.  
  115. digitValue
  116.     "Returns the value of self interpreted as a digit.  Here, 'digit' means
  117.     either 0-9, or uppercase A-Z, which maps to 10-35."
  118.     (self between: $0 and: $9) ifTrue: [ ^self asciiValue - 48 ].
  119.                 "48 is $0"
  120.     (self between: $A and: $Z) ifTrue: [ ^self asciiValue - 65 + 10 ].
  121.                 "65 is $A"
  122.     ^self error: 'Invalid digit character'
  123. !!
  124.  
  125.  
  126.  
  127. !Character methodsFor: 'comparing'!
  128.  
  129. < aCharacter
  130.     ^self asciiValue < aCharacter asciiValue
  131. !
  132.  
  133. <= aCharacter
  134.     ^self asciiValue <= aCharacter asciiValue
  135. !
  136.  
  137. > aCharacter
  138.     ^self asciiValue > aCharacter asciiValue
  139. !
  140.  
  141. >= aCharacter
  142.     ^self asciiValue >= aCharacter asciiValue
  143. !!
  144.  
  145.  
  146.  
  147. !Character methodsFor: 'testing'!
  148.  
  149. isDigit
  150.     "True if self is a 0-9 digit"
  151.     ^self between: $0 and: $9
  152. !
  153.  
  154. isLetter
  155.     "True if self is an upper- or lowercase letter"
  156.     ^(self between: $a and: $z) or: [ self between: $A and: $Z ]
  157. !
  158.  
  159. isAlphaNumeric
  160.     "True if self is a letter or a digit"
  161.     ^self isLetter or: [ self isDigit ]
  162. !
  163.  
  164. isLowercase
  165.     "True if self is a lowercase letter"
  166.     ^self between: $a and: $z
  167. !
  168.  
  169. isUppercase
  170.     "True if self is uppercase"
  171.     ^self between: $A and: $Z
  172. !
  173.  
  174. isSeparator
  175.     "Returns true if self is a space, cr, tab, nl, or newPage"
  176.     self > Character space ifTrue: [ ^false ].
  177.     self = Character space ifTrue: [ ^true ].
  178.     self = Character cr ifTrue: [ ^true ].
  179.     self = Character tab ifTrue: [ ^true ].
  180.     self = Character nl ifTrue: [ ^true ].
  181.     self = Character newPage ifTrue: [ ^true ].
  182.     ^false
  183. !
  184.  
  185. isVowel
  186.     "Returns true if self is a, e, i, o, or u; case insensitive"
  187.     | char |
  188.     char _ self asLowercase.
  189.     char = $a ifTrue: [ ^true ].    
  190.     char = $e ifTrue: [ ^true ].    
  191.     char = $i ifTrue: [ ^true ].    
  192.     char = $o ifTrue: [ ^true ].    
  193.     char = $u ifTrue: [ ^true ].    
  194.     ^false
  195. !!
  196.  
  197.  
  198.  
  199. !Character methodsFor: 'Coercion methods'!
  200.  
  201. asLowercase
  202.     "Returns self as a lowercase character if it's an uppercase letter,
  203.      otherwise returns the character unchanged."
  204.     self isUppercase ifFalse: [ ^self ].
  205.     ^Character value: (self asciiValue) + 32
  206. !
  207.  
  208. asUppercase
  209.     "Returns self as a uppercase character if it's an lowercase letter,
  210.      otherwise returns the character unchanged."
  211.     self isLowercase ifFalse: [ ^self ].
  212.     ^Character value: (self asciiValue) - 32
  213. !
  214.  
  215. asSymbol
  216.     "Returns the character self as a symbol."
  217.     ^Symbol internCharacter: self
  218. !!
  219.  
  220.  
  221.  
  222. !Character methodsFor: 'printing'!
  223.  
  224. printOn: aStream
  225.     self storeOn: aStream
  226. !!
  227.  
  228.  
  229.  
  230. !Character methodsFor: 'storing'!
  231.  
  232. storeOn: aStream
  233.     aStream nextPut: $$.
  234.     aStream nextPut: self
  235. !!
  236.  
  237.